package com.xiaobao.utils;

import org.jetbrains.annotations.NotNull;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class CorsConfig {

    /**
     * 配置跨域请求处理
     * 由于Web应用可能需要从不同的源接收请求，例如本地开发环境或特定的前端服务器，
     * 因此这里我们配置了跨域资源共享（CORS）来允许这些特定源的请求
     *
     * @return WebMvcConfigurer 接口的实现，用于配置跨域请求处理
     */
    @Bean
    public WebMvcConfigurer corsConfigurer() {
        return new WebMvcConfigurer() {
            /**
             * 添加跨域映射配置
             * 此方法配置了所有路径（"/**"）的跨域请求都可以从指定的源访问这些源包括本地开发环境
             * 和另一个前端URL同时，我们只允许GET、POST、PUT和DELETE方法，并接受所有类型的请求头
             * 此外，我们允许凭证（如cookies）的传输，这在某些场景下是必须的
             *
             * @param registry CorsRegistry对象，用于注册跨域映射
             */
            @Override
            public void addCorsMappings(@NotNull CorsRegistry registry) {
                registry.addMapping("/**")
                        .allowedOrigins("http://localhost:5173", "http://another-frontend-url.com")
                        .allowedMethods("GET", "POST", "PUT", "DELETE")
                        .allowedHeaders("*")
                        .allowCredentials(true);
            }
        };
    }
}